home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 February / EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso / earcd / util4 / alog10.lha / alog / alog.readme < prev   
Text File  |  1995-12-13  |  6KB  |  217 lines
  1. Short: different logfile entries in ONE window
  2. Type: util/misc
  3. Uploader: cosinus@deepthought.north.de (Christian Stelter)
  4. Author: atte@crash.north.de (Andreas Gelhausen)
  5.  
  6. System requirements:   Kickstart 2.04+
  7.  
  8.  
  9. Copyright
  10. =========
  11.  
  12.    alog 37.2 (Release 1.0) - Copyright © 1994 by Andreas Gelhausen,
  13. all rights reserved.
  14.  
  15.    alog is freely distributable. No part of this archive is allowed
  16. to be distributed with commercial software without written permission
  17. of the author.
  18.  
  19.  
  20. No Warranty
  21. ===========
  22.  
  23.    No warranties are made for this program. All use is at your own risk.
  24. No liability or responsibility is assumed for any damages occured
  25. during the usage of alog. You have been warned.
  26.  
  27.  
  28. Usage
  29. =====
  30.  
  31.    Do you have many tools installed and each of them prints in an own
  32. logfile (or in a logwindow)? Do you want all these entries displayed
  33. in only one logwindow? Then you should try alog with all its options.
  34.  =¦^)
  35.  
  36.    alog is a small program that allows you to get the new entries from
  37. a certain logfile and prints it wherever you want (similar to 'tail'
  38. under UNIX).
  39.  
  40.  
  41. You can select the following options:
  42.  
  43.    TOOLPRI/K/N:
  44.  
  45.       You can set the task priority of alog from -128 to 127.
  46.  
  47.       Example:
  48.                1> alog toolpri=1 <other_parameters>
  49.  
  50.    FROM/K/A:
  51.  
  52.       Here you have to specify the logfile, where alog gets the new
  53.       entries from.
  54.  
  55.    TO/K:
  56.  
  57.       This option allows you to specify an output file for alog that
  58.       will be opened and closed for each line alog writes into it.
  59.  
  60.    PERMANENT/S:
  61.  
  62.       If one of your tools runs in the background ('AmiTCP' for
  63.       example) and its logfile won't be closed during its usage
  64.       or the used filesystem doesn't support notify messages, alog
  65.       won't get notify messages when new entries will be written
  66.       to the specified logfile.
  67.       For those tools/filesytems you can select the option PERMANENT
  68.       and alog will check if new entries have arrived from time to time.
  69.       (See also option INTERVAL.)
  70.  
  71.       Example:
  72.                1> alog from t:AmiTCP.log permanent addedonly
  73.  
  74.                will print each new entry of t:AmiTCP.log to shell. 
  75.                (See also option ADDEDONLY.)
  76.  
  77.    INTERVAL/K/N:
  78.  
  79.       If you have selected the option PERMANENT, you can set the
  80.       time between the tests for new entries.
  81.  
  82.       Example:
  83.                1> alog from t:AmiTCP.log permanent addedonly interval 10
  84.  
  85.                will print the new entries of t:AmiTCP.log each 10
  86.                seconds to shell.
  87.                (See also option ADDEDONLY.)
  88.  
  89.    ADDEDONLY/S:
  90.  
  91.       If you select this option, only the new entries which will be
  92.       added to a given logfile will be printed. 
  93.  
  94.    HEADER/K:
  95.  
  96.       This option allows you to set an own header for the messages.
  97.  
  98.       Example:
  99.                1> run alog from t:test header "TEST-HEADER: "
  100.                [CLI 11]
  101.                1> echo "blafasel" >t:test
  102.  
  103.                and you will get the message "TEST-HEADER: blafasel".
  104.  
  105.    STRIPLEFT/K/N:
  106.  
  107.       Some tools have their own headers. You can strip those headers
  108.       by setting STRIPLEFT to their length.
  109.  
  110.       Example:
  111.                1> run alog from t:test stripleft 30
  112.                [CLI 11]
  113.                1> echo "HEADER-YOU-DON'T-WANT-TO-SEE: blafasel" >t:test
  114.  
  115.                and you will receive the message "blafasel".
  116.  
  117.    MAXLINELEN/K/N:
  118.  
  119.       This option allows you to handle very long messages. It's useful
  120.       by using small logwindows.
  121.  
  122.       Example:
  123.                1> run alog from t:test maxlinelen 12
  124.                [CLI 11]
  125.                1> echo "FIRST LINE  SECOND LINE THIRD LINE"
  126.  
  127.                and you will receive the message "FIRST LINE
  128.                                                  SECOND LINE
  129.                                                  THIRD LINE".
  130.  
  131. Now I hope you know how you have to use all of alog's options and I
  132. will try to explain, what you have to do to get the logfile entries
  133. of all your tools into ONE logwindow.
  134.  
  135. If you want to display the log messages of x tools, you have to start
  136. alog at x+1 times.
  137.  
  138.  
  139. How to install alog
  140. ===================
  141.  
  142. 1. Add the following line to your s:user-startup...
  143.  
  144.    run alog from t:alog.out >CON:0/0/640/100/message_window/WAIT/CLOSE
  145.  
  146.    This is the main process of alog. Everything that is printed to
  147.    t:alog.out will be printed to your message window.
  148.  
  149.    Try:
  150.        1> echo "WARNING: alog found in your system! =¦^)" >t:alog.out
  151.  
  152.    or:
  153.        1> date >t:alog.out
  154.  
  155. 2. If you want to see the new entries of a certain logfile <logfile>
  156.    in your message window, you only have to start alog with following
  157.    parameters:
  158.  
  159.    1> run alog from <logfile> to t:alog.out addedonly
  160.  
  161.    Don't forget: For some tools (like AmiTCP) you have to use the option
  162.    PERMANENT.
  163.  
  164. That's it.  =¦^)
  165.  
  166.  
  167. Example installation
  168. ====================
  169.  
  170. Now you will see some examples for certain tools.
  171. The command line...
  172.  
  173.   run >nil: dh0:utilities/alog from t:alog.out
  174.    >"CON:210/885/814/139/alog on crash.north.de/INACTIVE/WAIT/CLOSE"
  175.  
  176. prints all entries from t:alog.out to the specified message window.
  177. The next command lines are examples for AmiTCP...
  178.  
  179.   run >nil: dh0:utilities/alog from t:AmiTCP.log to t:alog.out addedonly
  180.    permanent interval 5 stripleft 34 header "*E[32m[ AmiTCP ]*E[0m "
  181.  
  182. for UMS...
  183.  
  184.   run >nil: dh0:utilities/alog from Basket:logfiles/ums.log to t:alog.out
  185.    addedonly permanent stripleft 20 header "*E[32m[  UMS   ]*E[0m "
  186.  
  187. and for Cron...
  188.  
  189.   run >nil: dh0:utilities/alog from t:CronLog to t:alog.out addedonly
  190.    header "*E[32m[  Cron  ]*E[0m "
  191.  
  192. which all prints to 't:alog.out'.
  193.  
  194.  
  195. How to reach the author
  196. =======================
  197.  
  198.    If you have questions, suggestions, bug reports or anything else,
  199. you can send electronic mails to:
  200.  
  201.               atte@crash.north.de (Andreas Gelhausen)
  202.  
  203.    If it is not possible for you to use this way, you can also send 
  204. letters to:
  205.  
  206.                        Andreas Gelhausen
  207.                        Graf Spee Str. 23b
  208.                        26123 Oldenburg
  209.                           - Germany -
  210.  
  211.  
  212. alog's history
  213. ==============
  214.  
  215. 12-Dec-95  Release 1.0  Program version 37.2  (first public release)
  216.  
  217.